home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / pcbv310.zip / PCBV310.DOC < prev    next >
Text File  |  1990-08-20  |  46KB  |  1,123 lines

  1.  
  2.  
  3.  
  4.                                     PCBVerify 3.10
  5.  
  6.                          Callback verification door software
  7.  
  8.                       Copyright (c) 1987-1990 By Curtis Kowalski
  9.  
  10.  
  11.                                      INTRODUCTION
  12.                                      ------------
  13.  
  14.                PCBVerify is  a door program  written for PCBoard  and other
  15.           bulletin board software which alleviates a Sysop's need to verify
  16.           his users by phone.  PCBVerify takes over this job, calling users
  17.           while they are  online at  giving instantaneous verification  and
  18.           access.   Now your  callers needn't wait  for you to  call them -
  19.           they  can  have PCBVerify  do  it automatically  and  raise their
  20.           access levels on their first call.
  21.  
  22.                                STANDARD "DEMO" LICENSE
  23.                                -----------------------
  24.  
  25.                PCBVerify is a  Shareware program, and uploading of the code
  26.           to various bulletin boards and Shareware libraries is encouraged.
  27.           Several limitations must be implied, however:
  28.  
  29.           1)  Under  no  circumstances  should  the  code  be  modified  or
  30.           distributed  in  any  other  form than  what  it  was  originally
  31.           supplied by the  author.  The exception is  that PCBVerify may be
  32.           compressed using techniques other than ZIP, but the de-compressed
  33.           form of PCBVerify must remain intact.
  34.  
  35.           2) PCBVerify may  not be redistributed  in any manner other  than
  36.           electronic   file  transfer  unless   cleared  with   the  author
  37.           beforehand.  No  money may  be received for  PCBVerify except  to
  38.           cover  for telecommunications  / service  charges, and in  such a
  39.           case the cost may not exceed $5.00 US.  
  40.  
  41.                PCBVerify may be run for a period of time  adequate to allow
  42.           for full testing of the software.  If, after running the code for
  43.           one month, you  decide not to  purchase the registration  license
  44.           and number,  you must forfeit  this license and  remove PCBVerify
  45.           from operation on your system(s).  You may keep a copy online for
  46.           distribution purposes only.
  47.                PCBVerify  may not  be  hacked or  modified  in ANY  manner,
  48.           including but not limited to modifications  leading to the use of
  49.           features intended for registered users only.   These features are
  50.           marked in this documentation as "Registered Version Only."  Also,
  51.           the  registration  license  in  non-transferrable  and  under  no
  52.           circumstance may the registration number of another individual be
  53.           used to enable these features or for any other purpose.
  54.  
  55.                                  REGISTRATION LICENSE
  56.                                  --------------------
  57.  
  58.           1)   Once purchasing the  registration license, several  features
  59.           are added  and the  license is  extended  for life.   All  future
  60.           releases  of PCBVerify will be made available, registered, for no
  61.           additional charge.   In any  event that PCBVerify  does not  work
  62.           properly, the  author, Curtis  Kowalski, shall  be liable  for no
  63.           more than $15.00 US, and then only if an honest attempt  was made
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           to contact the author and the situation remained unresolved.
  71.  
  72.           2)   Registering PCBVerify entitles  the registering party access
  73.           to  Premier  BBS or  whatever  location  that  support  is  being
  74.           maintained.   This privilege  is guaranteed  for as  long as  the
  75.           program  is  being  developed  and  supported.    Access  may  be
  76.           terminated if any rules or regulations  of the bulletin board are
  77.           broken by the registering party.
  78.  
  79.           3)   The  registration   license  is   non-refundable  and   non-
  80.           transferrable  without   prior  consent  of  the  author,  Curtis
  81.           Kowalski.   The name  of the  bulletin  board may  be changed  if
  82.           evidence is given that the board  is truly changing names and  in
  83.           such a case the old registration number may not be used under any
  84.           circumstances.
  85.  
  86.                                       DISCLAIMER
  87.                                       ----------
  88.  
  89.                The  author, Curtis  Kowalski, takes  no responsibility  nor
  90.           liability  for any data loss, incurred costs, or equipment damage
  91.           resulting from the use of PCBVerify, unless evidence can be given
  92.           to show that the code was written to do so intentionally.  
  93.  
  94.                                      BETA TESTING
  95.                                      ------------
  96.  
  97.                Beta testing is open  to the general  public.  For all  beta
  98.           copies the  above disclaimer  applies, since  the purpose  behind
  99.           beta testing software  is to insure  that no problems exist  with
  100.           the software.   Each version  is extensively beta  tested by  the
  101.           general public, and alpha tested by the author on his own system.
  102.           Care is taken that  PCBVerify is not released with  any problems,
  103.           but please keep in  mind that with the variety  of configurations
  104.           possible it is difficult to catch  some bugs.  If you discover  a
  105.           bug  in  PCBVerify, please  contact  the  author and  notify  him
  106.           immediately.
  107.  
  108.                                 CONFIGURING PCBVERIFY
  109.                                 ---------------------
  110.  
  111.                PCBVerify is included with a small 'Quick and dirty' utility
  112.           called PCBVSET to aid in setup.   PCBVSET is not intended to help
  113.           you syntax your  configuration options  - it is  merely there  to
  114.           help you 'get  things in the right  place.'  A list  of questions
  115.           will be asked of you when running PCBVSET, and many will be self-
  116.           explanatory.  A brief description  of the PCBVerify configuration
  117.           file is given below,  including details on some of  the questions
  118.           you may be asked when running PCBVSET.
  119.  
  120.                              PCBVERIFY CONFIGURATION FILE
  121.                              ----------------------------
  122.  
  123.           Line Description                        Example
  124.           ---- ---------------------------------  ------------------------
  125.            1   Configuration file identifier      PCBVerify 3.1 Config file
  126.            2   Comport to use                     COM1
  127.            3   Baud rate locking option           N
  128.            4   SYS file location/name             D:\PCB\PCBOARD.SYS
  129.            5   System type mode                   PCB14
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.            6   Board name                         Premier BBS
  137.            7   Registration number                0
  138.            8   USERS (or RESULTS) file location   D:\PCB\MAIN\USERS
  139.            9   LOG file location                  D:\PCB\MAIN\CALLER1
  140.           10   New user security level            10
  141.           11   Level to raise user to             40
  142.           12   Minutes to add to time limit       45
  143.           13   New D/L Byte limit to give user    32767
  144.           14   PCBVVER file enable?               Y
  145.           15   Add ldist #s not verified to 
  146.                PCBVVER?                           Y
  147.           16   External registration prg option   N
  148.           17   Callback mode enable               Y
  149.           18   Expiration date adjustment         +365.25
  150.           19   New expired security level         10
  151.           20   Sysop maintained cmnt fld option   Y
  152.           21   Standard phone number input mode   Y
  153.           22   Delay time betw. hangup & dialout  12
  154.           23   Prompt for user name instead of
  155.                password?                          Y
  156.  
  157.           =--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=--=
  158.  
  159.           Comport to use?
  160.           ---------------
  161.  
  162.           Tells PCBVerify which comport to use.  Presently values valid are
  163.           COM1  and COM2.   COM3, COM4, and  other comport support  will be
  164.           available in the near future.
  165.  
  166.           Baud rate locking option
  167.           ------------------------
  168.  
  169.           Tells PCBVerify if you  want to lock in at a  specific baud rate.
  170.           This option  will be  used if you  are running PCB12SYS  or PCB12
  171.           modes.  Otherwise, the baud rate to open the port at will be read
  172.           from the .SYS file.  
  173.  
  174.           This  field will  accept "N"  which  means DO  NOT lock  in  at a
  175.           specific baud rate.  If you are locking the comport at a specific
  176.           baud rate, place the baud rate  in this field.  Baud rates  valid
  177.           are: 300,1200,2400,4800,9600,19200,38400.
  178.  
  179.  
  180.           SYS file location/name
  181.           ----------------------
  182.  
  183.           This tells PCBVerify where  to find the .SYS file, whether  it be
  184.           PCBOARD.SYS, DOOR.SYS, or PCBV.SYS.
  185.  
  186.           System type
  187.           -----------
  188.  
  189.           This tells  PCBoard what type of system you  are using.  For non-
  190.           PCBoard systems, this tells  PCBVerify whether you are  using the
  191.           DOOR.SYS  standard or  a  PCBV.SYS converter.   System  types are
  192.           listed below:
  193.  
  194.           PCB12 - PCBoard 12.x
  195.           PCB14 - PCBoard 14.x
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.           PCBSYS14 - PCBoard 14.x, with only the SYS file.
  203.                      Users file is not used.
  204.           PCBSYS12 - PCBoard 12.x, with only the SYS file.
  205.                      Users file is not used.
  206.           DOORSYS  - Door.Sys file standard.
  207.           PCBVSYS  - PCBV.Sys file.
  208.  
  209.           Board name
  210.           ----------
  211.  
  212.           This is  your BBS name.  Enter it here  EXACTLY as you want it to
  213.           appear on screen.   This field  is used when determining  whether
  214.           your registration number is valid, so do not change it unless you
  215.           have acquired a  new registration number or  have not registered.
  216.           Note that PCBVerify uses this field to  tell the user what system
  217.           is  calling whenever a connection is  made.  For example, it will
  218.           say:
  219.  
  220.           "This is PREMIER BBS calling to verify..."
  221.  
  222.           Registration number
  223.           -------------------
  224.  
  225.           If  this  number  matches  the  bulletin board  name,  registered
  226.           features are enabled.  Note that if  you have not paid the $15.00
  227.           registration fee, only a 0 may be entered here.
  228.  
  229.           Location / name of USERS or RESULTS file
  230.           ----------------------------------------
  231.  
  232.           If you are running a PCBoard  system, either PCB12 or PCB14 mode,
  233.           this field tells  PCBVerify where your  USERS file is located  so
  234.           that it may update the user record.
  235.  
  236.           If you  are not  running PCBoard,  and are  running in  PCBSYS14,
  237.           PCBSYS12, PCBVSYS, or  DOORSYS modes, this field  tells PCBVerify
  238.           what file to  create if the user  is successfully verified.   You
  239.           may then  use an external  program to check for  the existence of
  240.           this file and update the user record if it exists.
  241.  
  242.           Location / name of LOG file
  243.           ---------------------------
  244.  
  245.           This is the location and name  of the file you want PCBVerify  to
  246.           log  its activity to.   If running PCBoard,  this should point to
  247.           the  callers'  log.    Otherwise,  this  should be  a  file  used
  248.           exclusively for  PCBVerify, and the  name must  be different  for
  249.           each node you are  operating.  Also, the log file  that PCBVerify
  250.           creates SHOULD  NOT be modified  using a text  editor as  it will
  251.           disturb the record structure PCBVerify uses  to read and write to
  252.           the  file.  The  file is written  in random access  mode, with 62
  253.           characters  per line plus CR/LF, for a  total record length of 64
  254.           characters.
  255.  
  256.           New user security level
  257.           -----------------------
  258.  
  259.           This is the  level the user must  be in order to  use PCBVerify's
  260.           verification mode.   If the  user is ANY  other level,  PCBVerify
  261.           will  put him in the callback  mode, meaning that his access will
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.           not be modified.   On systems where PCBVerify cannot  acquire the
  269.           user  security level (PCBSYS12 or PCBSYS14),  it will assume that
  270.           the  user is a new user.   If callback mode  is disabled, and the
  271.           user is not a new user, he will be returned to the board.
  272.  
  273.           Security level of a VERIFIED user
  274.           ---------------------------------
  275.  
  276.           This is the level PCBVerify will raise the user to if  his number
  277.           is successfully verified.  On PCBSYS12 and PCBSYS14 systems, this
  278.           option will be  ignored since there  is no way  for PCBVerify  to
  279.           notify the  BBS software  of the new  security since  PCBOARD.SYS
  280.           does not have an entry for security level.
  281.  
  282.           Minutes to add if user if verified
  283.           ----------------------------------
  284.  
  285.           PCBVerify will add  this number of  minutes to the users  allowed
  286.           time on the system  if verified.  This will be  written to either
  287.           PCBOARD.SYS, PCBV.SYS, or  DOOR.SYS depending  on which mode  you
  288.           are running in.
  289.  
  290.           New D/L Byte limit of user
  291.           --------------------------
  292.  
  293.           This number will be  substituted directly into the .SYS  file you
  294.           are using if the user is verified.  If your system takes the  D/L
  295.           byte limit  in K, enter  this number in K.   If it  takes the D/L
  296.           byte limit in bytes, enter this number in bytes.  For example, if
  297.           you are using PCBoard 12.x, and wish to set the d/l byte limit to
  298.           unlimited, enter 9999.  For PCBoard 14.x, you would enter 32767.
  299.  
  300.  
  301.           Add number to PCBVVER after verifying? 
  302.           (REGISTERED VERSION ONLY)
  303.           --------------------------------------
  304.  
  305.           This option allows you to add each number verified to the PCBVVER
  306.           file, preventing a number  from being verified more than  once by
  307.           PCBVerify.   This option will be  ignored if you  are running the
  308.           demo version of PCBVerify.
  309.  
  310.           Add long distance number to PCBVVER even if not verified?
  311.           (REGISTERED VERSION ONLY)
  312.           ---------------------------------------------------------
  313.  
  314.           This option  allows you to add  numbers to PCBVVER that  are long
  315.           distance if the  user was not verified  on the first attempt,  to
  316.           prevent someone long  distance from entering a  number repeatedly
  317.           and running your bill up while attempting to get verified.
  318.  
  319.           External registration program option
  320.           ------------------------------------
  321.  
  322.           Enter "N" in this field if you do not want PCBVerify to branch to
  323.           another program if  the users' phone  number is included in  your
  324.           PCBVAL file.   Otherwise, enter the name of  the file you wish to
  325.           create when branching is necessary.  See the section on 'external
  326.           registration  doors'  later  in  this documentation  for  further
  327.           details.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.           Callback mode option
  336.           --------------------
  337.  
  338.           If  a Y  is  placed in  this  field, PCBVerify  will allow  local
  339.           callers who are not  new users to  use the 'callback mode'  which
  340.           simply  allows  the  user  to  be  called back.    Reversing  the
  341.           originating and  receiving modem often  will clear up  line noise
  342.           problems.
  343.  
  344.           Expire date adjust
  345.           ------------------
  346.  
  347.           If you  are using a system  which uses expiration dates,  you may
  348.           set PCBVerify to  add a  certain number  of days  to the  current
  349.           expiration date or you  may hard-code an expiration date  in this
  350.           field.  Whenever a user is verified, his expiration date will  be
  351.           updated with  the information  contained in  this field.   Either
  352.           enter +[number  of days  to add  to expdate]  or [yymmdd] in  the
  353.           field.
  354.  
  355.           New expired security level
  356.           --------------------------
  357.  
  358.           This fields holds the new expired security level to give the user
  359.           upon verification.
  360.  
  361.           Sysop maintained comment field
  362.           ------------------------------
  363.  
  364.           This field is  for PCBoard 12.x  and 14.x systems  only.  If  you
  365.           place a "Y" in this field, PCBVerify will  write the phone number
  366.           the user was verified at and  "PCBVERIFY" in the Sysop maintained
  367.           comment field in the USERS file.
  368.  
  369.           Separate phone number entry prompting
  370.           -------------------------------------
  371.  
  372.           This field, if it contains a "Y", causes PCBVerify to prompt  for
  373.           the areacode, prefix,  and suffix  separately.  If  you wish  for
  374.           PCBVerify to prompt for  the number in one  prompt, enter "N"  in
  375.           this field.   Note that an  explanation of where to  place dashes
  376.           should be  included in  your WELCOME  and CALLBACK  files if  you
  377.           place "N" in this field.  The "N" option is generally for systems
  378.           not located in North  America which use something other  than the
  379.           3-digit area code, 7-digit phone number.
  380.  
  381.           Delay time before dialing out
  382.           -----------------------------
  383.  
  384.           This is the time, in seconds, that PCBVerify will between hanging
  385.           up and dialing out.   In most phone  systems, the caller  usually
  386.           must hang up first.  If the receiver of the call hangs up  first,
  387.           and  the caller stays on  the line, it may  take up to 15 seconds
  388.           for  the  call  to  be  disconnected.     If  PCBVerify  were  to
  389.           immediately  pick up the line  to call out,  it would be possible
  390.           for the caller to stay on the line and play a recording of a dial
  391.           tone, then  hit ATA on  their modem  and fool PCBVerify  and your
  392.           modem into  thinking a  call had  actually been  placed when  the
  393.           first  had actually never  been disconnected.   To  prevent this,
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.           check with your phone company and find out how long it would take
  401.           to disconnect a  call if the receiver  of the call hung  up first
  402.           and the  originator stayed on  the line.   You should  place that
  403.           amount  in  this  field   to  insure  that  the  call   has  been
  404.           disconnected before the  modem picks back  up on the line  again.
  405.           Generally, this is 12 seconds, but may vary with newer and  older
  406.           phone systems.
  407.  
  408.           Password / name prompt
  409.           ----------------------
  410.  
  411.           Some systems cannot supply the users'  password to PCBVerify.  If
  412.           this is the case, you can set  PCBVerify to prompt for the user's
  413.           first and  last name instead  of his password.   Enter Y  in this
  414.           field if you  want PCBVerify  to ask  the user's  first and  last
  415.           name,  otherwise  enter  N  to  have  PCBVerify  prompt  for  the
  416.           password.
  417.  
  418.  
  419.                                  OPERATING PCBVERIFY
  420.                                  -------------------
  421.  
  422.           To  call  up   PCBVerify,  several  options  may/must   be  used.
  423.           Generally, the command is as follows:
  424.  
  425.           PCBV310 [config file]
  426.  
  427.           If you are running under a  network or multi-tasking environment,
  428.           add the "/NETWORK" switch after the config file.
  429.  
  430.           If you are running  under a system where PCBVerify  cannot locate
  431.           the  user's security level,  you can  set up  a separate  copy of
  432.           PCBVerify  invoked  with the  "/CBMODE"  switch which  will force
  433.           callback mode and  inhibit updating of security  level/time limit
  434.           etc.
  435.  
  436.           Examples:
  437.  
  438.           PCBV310 PCBV.CNF
  439.           PCBV310 PCBV.CNF /NETWORK
  440.           PCBV310 PCBV.CNF /NETWORK /CBMODE
  441.  
  442.  
  443.                                  PCBVERIFY BATCH FILE
  444.                                  --------------------
  445.  
  446.           When calling up PCBVerify, you may  want to include several other
  447.           lines in addition to  actual command to bring up PCBVerify.   For
  448.           example:
  449.  
  450.           1. if exist XREG1 del XREG1
  451.           2. if exist RESULT1 del RESULT1
  452.           3. PCBV310 PCBV.CNF /NETWORK
  453.           4. if exist RESULT1 UPDATE
  454.           5. if exist XREG1 XREGDOOR
  455.  
  456.           Lines 1  &  5 are  used  if you  are  running with  the  external
  457.           registration door  option.  If the  file XREG1 is left  over from
  458.           the last time in the  door, line 1 deletes it.  Line  five runs a
  459.           program called XREGDOOR if PCBVerify has created  the file XREG1,
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.           signalling the batch file that  the external registration program
  467.           should be run.  If the  user's phone number were not allowed  for
  468.           some reason, XREGDOOR could be run to allow the user to  fill out
  469.           a script, etc.
  470.  
  471.           Lines  2 and  4 are  used  if PCBVerify  cannot update  the users
  472.           security level  using PCBV.SYS,  DOOR.SYS, or  USERS.   PCBVerify
  473.           creates a file called RESULT1, which is deleted at line 2 if left
  474.           over from  a previous verification.   If  the file is  created by
  475.           PCBVerify, line 4 runs  a program called update which  would then
  476.           update the users security level.
  477.  
  478.  
  479.  
  480.                               PCBV.SYS FILE INFORMATION
  481.                               -------------------------
  482.  
  483.           PCBVerify has a special file format that can be used to interface
  484.           with  it  that allows  all information  needed to  be transferred
  485.           easily.  By writing a two-way conversion utility which reads from
  486.           and writes  to  PCBV.SYS, PCBVerify  can  pass and  retrieve  all
  487.           necessary information from the bulletin board package being used.
  488.           A  number  of  utilities  for RBBS  have  already  been  written,
  489.           allowing PCBVerify to do a full  upgrade of security, time limit,
  490.           and expiration date and security levels.  The conversion  package
  491.           reads in  the necessary  info from  the  doors information  file,
  492.           writes  it  to  PCBV.SYS.   PCBVerify  then  reads  PCBV.SYS  and
  493.           proceeds  as  usual.   When  exiting,  PCBVerify  writes the  new
  494.           information to PCBV.SYS.  The conversion utility is  then invoked
  495.           again and this time reads PCBV.SYS  and writes the information to
  496.           the USER database, etc. to reflect any new changes.  
  497.  
  498.           PCBV.SYS is a sequential text file in the following format:
  499.  
  500.           Line      Description
  501.           ----      -----------
  502.           1         CPU to modem baud rate (or the word "LOCAL")
  503.           2         Modem to mode baud rate (or the word "LOCAL")
  504.           3         Graphics mode (Y or N, or 7 for 7-e-1 operation)
  505.           4         First name of caller
  506.           5         Caller's first and last name
  507.           6         Caller's password
  508.           7         Page length of caller
  509.           8         Caller's security level
  510.           9         Caller's time available on system
  511.           10        Caller's D/L byte limit
  512.           11        Caller's EXPIRED security level
  513.           12        Caller's expiration date in yymmdd format
  514.  
  515.  
  516.                                  MULTI-NODE OPERATION
  517.                                  --------------------
  518.  
  519.           PCBVerify  performs share-compatible  read/writes with  all files
  520.           unless specified as being  non-network compatible files.   In the
  521.           event the files  are not  network compatible, your  configuration
  522.           for each node  must specify a  different filename.  Usually,  the
  523.           best method  of doing so is to pick a  base filename and append a
  524.           1,2,3 etc. to designate the node that file belongs to.  The files
  525.           non-network compatible are listed below:
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.           SYS file       (PCBoard.Sys, PCBV.SYS, etc.)
  534.           LOG file       (PCBV.LOG, CALLER1, CALLER2, etc.)
  535.           RESULT file    (non-PCB systems)
  536.           XREG file      (external registration file)
  537.  
  538.           Each  node  requires a  different .CNF  file,  so you  should run
  539.           PCBVSET for each  node you have in operation.  Be sure to include
  540.           the   /NETWORK  switch  after  the  configuration  filename  when
  541.           invoking PCBVerify.
  542.  
  543.  
  544.                                       FILENAMES
  545.                                       ---------
  546.  
  547.           PCBVerify  requires  that  several  files   reside  in  its  home
  548.           directory for it to operate properly.  They are:
  549.  
  550.           WELCOME   -  Initial user instructions (verification)
  551.           CALLBACK  -  Initial user instructions (callback mode)
  552.           GOODBYE   -  Goodbye message (informs user of new sec. level)
  553.           PCBVTEXT  -  File containing all text messages that appear
  554.  
  555.           If you are  running PCBoard  in the multi-lingual  mode, you  may
  556.           translate the  above four files for  each language as well.   For
  557.           example, if you are running French  and have translated the above
  558.           files into  French, store  the files  in the  PCBVerify directory
  559.           under [filename].FRE.  
  560.  
  561.           *NOTE*  If you  are capable of translating  the above files  into
  562.           any  other  language   besides  English,  it  would   be  greatly
  563.           appreciated if you  would send these  files to Premier BBS  (615)
  564.           522-2498.   I  will give a  free registration  to anyone  who can
  565.           provide me with legitimate translations of these files.
  566.  
  567.           PCBVAL    -  Allowed numbers file
  568.           PCBVNAL   -  Not allowed numbers file
  569.           PCBVTIME  -  Time formats file
  570.           PCBVVER   -  Verified numbers file
  571.  
  572.           The above files are described in detail below.
  573.  
  574.  
  575.                                  MODEM COMPATIBILITY
  576.                                  -------------------
  577.  
  578.           PCBVerify's   modem  tolerance  has   been  enhanced   in  recent
  579.           revisions.  Support for  all Hayes verbose modem result  codes is
  580.           now available.   Numeric codes  are not  supported.   If you  are
  581.           having problems with  PCBVerify working  with your modem,  please
  582.           contact me at Premier BBS @ (615) 522-2498 or through RelayNet at
  583.           Node ID ->PREMIER.
  584.  
  585.                                      PCBVVER FILE
  586.                                      ------------
  587.  
  588.           No initial setup is required for the PCBVVER file.  This  file is
  589.           where  PCBVerify  stores all  numbers  which have  been verified.
  590.           They are stored as follows:
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.           "[number]","[name of user]","[date] [other notes]"
  599.  
  600.           Please note that this file does not accept wildcard characters as
  601.           did the  old PCBVTC file.   This  was done in  order to  speed up
  602.           verified number checking.  If you had entries in your PCBVTC file
  603.           that  contained wilcards, they  should be moved  into the PCBVNAL
  604.           file (explained below).
  605.  
  606.                                      PCBVNAL FILE
  607.                                      ------------
  608.  
  609.           The PCBVNAL file  is used to store  numbers that you do  not want
  610.           PCBVerify to dial.  Here you should place your own BBS numbers as
  611.           well as the numbers of other  local boards and computer services,
  612.           etc.   Also, it  is recommended that  you place an  entry in this
  613.           file  for  the 976  and 1-900  numbers.   Wildcard  characters (?
  614.           marks) can  be used for any digit of the number or for the second
  615.           parameter (the user's response  when asked if the number  is long
  616.           distance).
  617.           The file works as follows:
  618.  
  619.           [number],[ldist flag]
  620.  
  621.           Examples:
  622.  
  623.           615-522-2498,Y (615-522-2498, if user says long dist)
  624.           615-522-2499,N (615-522-2499, if user says local)
  625.           615-123-4567,? (615-123-4567, local or long dist)
  626.           615-???-????,N (any 615 number if user says local)
  627.           900-???-????,? (blocks out all 900 numbers)
  628.  
  629.                                      PCBVAL FILE
  630.                                      -----------
  631.  
  632.           The PCBVAL is  the most complicated file that PCBVerify uses.  It
  633.           helps  PCBVerify  determine whether  or  not  to dial  a  certain
  634.           number, when that  number can be dialed,  and how to handle  that
  635.           call once connected.
  636.  
  637.           PCBVAL should always be  built with most specific entries  at the
  638.           beginning.    For  example, if  you  wanted  PCBVAL  to handle  a
  639.           specific number in  area code 615  seperate from all others,  you
  640.           would want to do the following:
  641.  
  642.           615-555-1212,N,N,A,"ATD %2-%3"
  643.           615-???-????,N,N,B,"ATD %2-%3"
  644.  
  645.           In this case, PCBVerify  reaches a match for the  555-1212 number
  646.           first, so it handles  it differently than the second  line, which
  647.           would be used for ANY 615 number.
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.           Load your favorite  editor and edit the  file PCBVAL.   Here's an
  666.           example to help explain how PCBVAL is used and set up:
  667.  
  668.           ???-???-????,N,N,A,"ATDT %2%3"
  669.           --- --- ---- - - -  ---------
  670.           |   |   |    | | |  |
  671.           |   |   |    | | |  +--------- 7. Dial command
  672.           |   |   |    | | +------------ 6. Time letter
  673.           |   |   |    | +-------------- 5. Disconnect flag (y/n)
  674.           |   |   |    +---------------- 4. User ldist flag (y/n)
  675.           |   |   +--------------------- 3. Number parm. 3
  676.           |   +------------------------- 2. Number parm. 2
  677.           +----------------------------- 1. Number parm. 1
  678.  
  679.           The above is a sample of the USA/Canada phone number conventions.
  680.           International setup is  only slightly  different and samples  are
  681.           given below.  Listed below is a description of each field.
  682.  
  683.           1. Area code.  First section  of the phone number entered by  the
  684.           user.  In international mode, all the digits up to the first "-".
  685.  
  686.           2. Prefix.   Second section  of the phone  number entered by  the
  687.           user.  In  international mode, all digits after the first "-" and
  688.           before the second "-".
  689.  
  690.           3. Suffix.  Third section of the phone number.   In international
  691.           mode, all digits  from the second  "-" to the  third, or in  this
  692.           entry's case, all digits from the second "-" to the end.
  693.  
  694.           You may have  up to nine parameters in your  phone number entries
  695.           in PCBVAL.  Each field is seperated by a dash.  If  you are using
  696.           PCBVerify in the  USA or  Canada, you needn't  worry about  this.
  697.           Otherwise, you will need to customize your PCBVAL file to reflect
  698.           the way phone numbers would look in your country.  
  699.  
  700.           4.  User-entered  long distance flag.   Aids  you in hitting  the
  701.           correct entry in PCBVAL.  For example, if you lived in Tennessee,
  702.           you might have two entries as below:
  703.  
  704.           615-???-????,N,N,A,"ATDT %2%3"
  705.           615-???-????,Y,N,A,"ATDT 1-%2%3"
  706.  
  707.           PCBVerify would dial prefix-suffix if the user said it was local,
  708.           otherwise it  would dial a 1 before the  prefix and suffix of the
  709.           phone number.
  710.  
  711.           5.  Disconnect flag.   This flag tells PCBVerify whether  to hang
  712.           up  after verifying this number or  return the user to the board.
  713.           If you are being charged by the minute for the phone call to this
  714.           number, you  should place Y here to disconnect the user and force
  715.           him to call back on his dime -  otherwise he would be returned to
  716.           the board where he could download  a meg. of files and you  would
  717.           end up paying the bill.   Placing an N here would return the user
  718.           to the board.  Also, in callback mode, PCBVerify will  only allow
  719.           numbers which have a  disconnect flag of "N" to  be called, since
  720.           the purpose  in  callback mode  would  be defeated  if  PCBVerify
  721.           simply hung up and the user had to call back again.
  722.  
  723.           6.  Time letter.  This letter (A-Z) tells PCBVerify what times to
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.           allow this number to be dialed.   See the section on the PCBVTIME
  731.           file later in this documentation.
  732.  
  733.           7.  Dial command.   This is  the dial string  to use for  numbers
  734.           matching this  PCBVAL entry.   Each field in  the phoe  number is
  735.           seperated  by  a dash.   USA/Canada  numbers  have an  area code,
  736.           prefix, and suffix, for a total of three fields.  Field 1 is area
  737.           code,  etc.  To  send a  part of  the phone  number in  your dial
  738.           command, use %  followed by the field number.   For example, ATDT
  739.           %2%3  would  dial prefix-suffix.    ATDT 1-%1%2%3  would  dial 1-
  740.           areacode, prefix, suffix.
  741.  
  742.           The new PCBVAL format  allows PCBVerify to operate with  a number
  743.           of different  phone systems.   You can  even set PCBVerify  up to
  744.           allow entry  of extension numbers.  For example,  if you are on a
  745.           PBX  system, you can set PCBVerify  up to take phone number entry
  746.           on one line (line  21 of PCBV.CNF file) and  include instructions
  747.           in the WELCOME and  CALLBACK files telling users to  simply enter
  748.           their extension number if they  are within your business/company,
  749.           etc.  For example:
  750.  
  751.           Number? 1456        User is at extension 1456, so he enters that.
  752.  
  753.           PCBVAL file:
  754.  
  755.           ????,N,N,A,"ATDT %1"
  756.           615-???-????,N,N,A,"ATDT 99-%2-%3"
  757.  
  758.           PCBVerify finds  line one, which  matches the  user's entry,  and
  759.           dials the extension number  straight out.  If  the user enters  a
  760.           regular phone number  in the format ac-pfx-sfx,  PCBVerfify dials
  761.           99 followed by the prefix and suffix.
  762.  
  763.           Thoroughly confused?   Here's a  couple of examples  to help  you
  764.           through  this.  Believe me,  it's as hard to explain  as it is to
  765.           understand !!
  766.  
  767.           Case 1 : Sysop in US, East Tennessee (I'm familiar with this one)
  768.  
  769.           If the  Sysop wanted only to call local callers, and none others,
  770.           he would enter:
  771.  
  772.           615-???-????,N,N,A,"ATDT %2-%3"
  773.  
  774.           The 615-???-????,N tells PCBVerify  to use any number in  the 615
  775.           area code in which  case the user enters "no" to  the question as
  776.           to whether or  not his number is long distance.   PCBVerify would
  777.           would return the user to the board, use time letter A,  and would
  778.           dial the second  and third  fields in the  phone number  (prefix-
  779.           suffix).
  780.  
  781.           If I wanted to  add long distance callers inside of  615, I could
  782.           add this line:
  783.  
  784.           615-???-????,Y,Y,A,"ATDT 1-%2-%3"
  785.  
  786.           If a  user  enters any  615  number and  says  "yes" it  is  long
  787.           distance, PCBVerify  will stop  at this  line.   This line  tells
  788.           PCBVerify to disconnect  after verifying, use time  letter A, and
  789.           dial the number as 1-prefix-suffix.
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.           To add long distance  outside of Tennessee, the final  line would
  798.           be:
  799.  
  800.           ???-???-????,Y,Y,A,"ATDT 1-%1-%2-%3"
  801.  
  802.           This line tells PCBVerify to take any number in any area code, if
  803.           they said it  was long  distance, and disconnect  the call  after
  804.           verification is completed.  It will  use time letter A, and would
  805.           dial the phone number as 1-areacode-prefix-suffix.  
  806.  
  807.           You can  change the ATDT to include any  strings you wanted.  For
  808.           example, if you  wanted to  dial a long  distance company  access
  809.           code before dialing an out-of-state  number, the above line could
  810.           be as follows:
  811.  
  812.           ???-???-????,Y,Y,A,"ATDT 10288-1-%1-%2-%3"
  813.  
  814.  
  815.           Case 2: A sysop outside of the USA/Canada
  816.  
  817.           Okay, now, lets  take a  case where  your phone system  is a  bit
  818.           different from that in the USA/Canada area...
  819.  
  820.           First of all, you will need to set PCBVerify up to take the phone
  821.           number in one prompt.  This question is asked in PCBVSET.  If you
  822.           accidentally  set PCBVerify  up to  prompt for  the USA/Canada  3
  823.           digit  areacode,  7 digit  number,  you can  change  this option.
  824.           Simply load your favorite editor and edit your configuration file
  825.           line 21  to say "N".  Then modify  the WELCOME and CALLBACK files
  826.           to tell your callers to carefully enter their phone number in the
  827.           format that you  will set up your PCBVAL  file to take.   In this
  828.           example, it would be [two digit city code]-[five digit number].
  829.  
  830.           Say you have a five digit phone number, and a two digit city code
  831.           to deal  with.   You live  in city  code 21,  and all  calls made
  832.           inside of that area  are toll-free.  To call someone  in your own
  833.           city/area, you simply dial  their five digit number.   Your first
  834.           line would be:
  835.  
  836.           21-?????,N,N,A,"ATDT %2
  837.  
  838.           PCBVerify will use this entry if the user said the call was local
  839.           and entered  a 21 followed  by a dash and  any five numbers.   It
  840.           would  stay  online  and  return  the  user to  the  board  after
  841.           verifying,  and  would simply  send ATDT  [five  digit #]  to the
  842.           modem.
  843.  
  844.           Now, let's say that the other city  codes are toll calls, but you
  845.           want to include them as well.   To dial someone in another  city,
  846.           you simply dial [city code]-[phone #].  Your next line would be:
  847.  
  848.           ??-?????,Y,Y,B,"ATDT %1-%2"
  849.  
  850.           PCBVerify would take  any number the  user entered if it  started
  851.           with  any two  digits,  followed by  a  dash, and  then  any five
  852.           digits.  It  would dial  the number as  [first two  digits]-[last
  853.           five digits] and would disconnect the user after verification was
  854.           complete.
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.           PCBVAL includes many,  many possibilities for configuration.   If
  863.           you have any questions at all about setting up PCBVAL or any part
  864.           of PCBVerify,  please  leave a  message  at Premier  BBS  through
  865.           RelayNet DOORS  conference (node  id ->PREMIER)  or on the  board
  866.           direct @ (615) 522-2498.
  867.  
  868.  
  869.                                     PCBVTIME file
  870.                                     -------------
  871.  
  872.           The  PCBVTIME file  is used to  define periods  of time  in which
  873.           various  phone numbers may be  dialed.  In  PCBVTIME you assign a
  874.           letter, A-Z, to a period of time.   That letter is used in PCBVAL
  875.           to tell PCBVerify when that phone number can be dialed.  The file
  876.           is laid out as follows:
  877.  
  878.           [letter],[weekday  start],[weekday end],[weekend  start],[weekend
  879.           stop]
  880.  
  881.           For example:
  882.  
  883.           A,00:00,24:00,00:00,24:00
  884.           B,23:00,07:00,23:00,17:00
  885.           - ----- ----- ----- -----
  886.           |   |     |     |     |
  887.           |   |     |     |     +------ Weekend stop (Sunday)
  888.           |   |     |     +------------ Weekend start (Friday)
  889.           |   |     +------------------ Weekday stop
  890.           |   +------------------------ Weekday start
  891.           +---------------------------- Letter used in PCBVAL
  892.  
  893.           Line 1 allows any PCBVAL entry with time letter A to be dialed 24
  894.           hours.  Note  that for midnight,  the start time should  be 00:00
  895.           while  the stop time should  be 24:00.   This will help PCBVerify
  896.           determine  exactly when  to stop  and start allowing  the numbers
  897.           with that letter to be dialed.  Times should always be entered in
  898.           24 hour format.
  899.  
  900.           Line 2 allows  PCBVAL entries with letter B  to be dialed between
  901.           11:00 PM and 7:00  AM through the week, and from  11:00 PM Friday
  902.           through 5:00 PM Sunday, and starting  again Sunday night at 11:00
  903.           PM.   This entry  allows the number  to be  dialed only  when the
  904.           rates are cheapest.
  905.  
  906.           Note that on the  unregistered copy, PCBVerify will not  read the
  907.           second line of the PCBVTIME file.
  908.  
  909.                                     PURGE UTILITY
  910.                                     -------------
  911.  
  912.           PCBVerify now has  a small purge  utility for PCBoard sysops  who
  913.           would like to clear the PCBVVER file  of any users that no longer
  914.           exist in the  USERS file.  First, the USERS file for PCBoard must
  915.           be purged to  insure that  all deleted users  have been  removed.
  916.           Then,  from  the  PCBVerify directory  (where  your  PCBVVER must
  917.           reside) run PURGE as follows:
  918.  
  919.           PURGE [index file directory]
  920.  
  921.           For example:
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.           PURGE D:\PCB\MAIN
  930.  
  931.           This tells PCBVerify  to remove any  users from PCBVVER that  are
  932.           not found in the index files in the D:\PCB\MAIN  directory.  Note
  933.           that if the index  files are not  found, the entire PCBVVER  file
  934.           would be purged.   A backup file is made, however, so if you give
  935.           it the wrong directory, don't worry.
  936.  
  937.                                 REGISTERING PCBVERIFY
  938.                                 ---------------------
  939.  
  940.           In order to  register PCBVerify, either fill out the registration
  941.           form at the  end of  this document and  send it  with a check  or
  942.           money  order  for $15.00  to  the  address given  below,  or call
  943.           Premier  BBS at  (615) 522-2498/99 and  register by  credit card.
  944.           Visa, Mastercard, Discover, and American Express are accepted.
  945.  
  946.           To register on Premier BBS, type DOOR 5 at the Main Board Command
  947.           prompt.   Then  follow  the  prompts entering  your  board  name,
  948.           address, phone numbers,  etc.  You  will be given a  registration
  949.           number while you are online.
  950.  
  951.           Why  register?  PCBVerify  is Shareware program,  meaning you are
  952.           licensed to use it for a limited  period of time, after which you
  953.           must stop using it or register  your copy.  If you register,  the
  954.           enhanced  features  will  be  activated,   you'll  have  a  clear
  955.           conscience,  and   lifetime  technical  support.     Once  you've
  956.           registered PCBVerify,  you will  be given  a registration  number
  957.           which  activates  the  registered  copy  of  the  software.    No
  958.           downloading  of additional software is  required.  Also, once you
  959.           have  registered, you will  be able to  use all  new features and
  960.           future releases of PCBVerify as well.
  961.  
  962.                                      PREMIER BBS
  963.                                      -----------
  964.  
  965.           Premier BBS  has once  again changed  phone numbers,  and I  have
  966.           changed addresses as well.  The new information is listed below:
  967.  
  968.                               Premier BBS / PCBVerify Tech Support
  969.                               (615) 522-2498 (2400, rings both nodes)
  970.                               (615) 522-2499 (9600 baud Hayes)
  971.  
  972.           The new address is:
  973.  
  974.                                    Curtis Kowalski
  975.                                    PCBVerify Registration
  976.                                    2312 Vincinda Circle
  977.                                    Knoxville, Tn. 37924
  978.  
  979.           Sysops  who  request  access  to  Premier  will  be  given access
  980.           immediately.   Note that even  if you have  registered PCBVerify,
  981.           you will  not get access until you ask.  The reason is that it is
  982.           difficult to register  those who register  by mail on the  board,
  983.           and  instant upgrade from the online  registration door cannot be
  984.           given for security  reasons.  To get  access to Premier,  all you
  985.           need to is leave a short comment telling me who you are  and what
  986.           your board's name and phone number is.
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                              PCBVERIFY REGISTRATION FORM
  1061.  
  1062.  
  1063.  
  1064.           Sysop name: ___________________________________________
  1065.  
  1066.           Address   : ___________________________________________
  1067.  
  1068.                       ___________________________________________
  1069.  
  1070.           Home phone: __________________
  1071.  
  1072.           Board(s) to register: (EXACTLY as you want it to appear on screen)
  1073.  
  1074.                ____________________________________  Phone: _______________
  1075.  
  1076.                ____________________________________  Phone: _______________
  1077.  
  1078.                ____________________________________  Phone: _______________
  1079.  
  1080.  
  1081.           May your check / money order payable to Curtis Kowalski  and mail
  1082.           to:
  1083.  
  1084.                                    Curtis Kowalski
  1085.                                    PCBVerify Registration
  1086.                                    2312 Vincinda Circle
  1087.                                    Knoxville, Tn. 37924
  1088.  
  1089.           You  will receive your registration number by  mail in a few days
  1090.           after I receive  your form.   If you do  not hear anything  after
  1091.           approximately 3  weeks, please contact  me at Premier  BBS, (615)
  1092.           522-2498/99.
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.